home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / miser_submit.z / miser_submit
Encoding:
Text File  |  2002-10-03  |  7.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))                                                mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      miser_submit - submit a job to a miser queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt -q qqqqnnnnaaaammmmeeee -f ffffiiiilllleeee command | -h
  13.  
  14.      mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt -q qqqqnnnnaaaammmmeeee -o c=CCCCPPPPUUUUssss,m=mmmmeeeemmmm,t=ttttiiiimmmmeeee[,static] command
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _m_i_s_e_r__s_u_b_m_i_t command is used to submit a job (the command) to a
  18.      _m_i_s_e_r(_1) queue.  A job is an application that will be scheduled by miser.
  19.      Any application that does not change its session ID or change its process
  20.      group ID can be submitted to a miser queue.  For an application to be
  21.      properly submitted to a _m_i_s_e_r(_1) queue, it needs to specify its resource
  22.      schedule.  A resource schedule is a list of resource specifications,
  23.      called segments, that define the resource requirements of a particular
  24.      job.  A resource specification is a tuple of CPUs, memory and wall clock
  25.      time.  Currently _m_i_s_e_r(_1) only supports resource schedules consisting of
  26.      one segment.  A segment also has additional optional fields that specify
  27.      how the job is to be scheduled.  These are defined in _m_i_s_e_r__s_u_b_m_i_t(_4).
  28.  
  29.      An application is said to be scheduled by _m_i_s_e_r(_1), if it can find a
  30.      block of time/space in the resources managed by the specified queue to
  31.      schedule each segment of the application's resource schedule.  If miser
  32.      can find such a block, then a schedule is returned to the user.  The
  33.      schedule is a list of start and end times for each segment of the
  34.      resource schedule.  The end times are guaranteed by miser, in other
  35.      words, either the application will have terminated by then or the
  36.      application will be terminated.  Miser will do a first fit of each
  37.      segment of the schedule in the specified queue.
  38.  
  39. DDDDIIIISSSSPPPPLLLLAAAAYYYY
  40.      The format of the schedule returned by _m_i_s_e_r__s_u_b_m_i_t is a table that
  41.      lists:
  42.  
  43.      JJJJOOOOBBBBIIIIDDDD
  44.           The batch ID is used by miser, various miser commands, and the
  45.           kernel to communicate about a specific job.  It is equivalent to the
  46.           process group id.
  47.  
  48.      CCCCPPPPUUUU  The number of CPUs allocated.
  49.  
  50.      MMMMEEEEMMMM  The amount of memory allocated shown in bytes, kilobytes(k),
  51.           megabytes(m), or gigabytes(g).
  52.  
  53.  
  54.      DDDDUUUURRRRAAAATTTTIIIIOOOONNNN
  55.           The duration or the total wall clock time is the product of the CPU
  56.           time and the number of CPUs.  (duration = wall clock time per CPU *
  57.           number of CPUs)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))                                                mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))
  71.  
  72.  
  73.  
  74.      SSSSTTTTAAAARRRRTTTT TTTTIIIIMMMMEEEE
  75.           The starting time is when the job is going to get batch critical
  76.           priority, if running opportunistically (NON-STATIC); or will start
  77.           running if submitted as STATIC.
  78.  
  79.      EEEENNNNDDDD TTTTIIIIMMMMEEEE
  80.           The completion time is when Miser has scheduled the job to
  81.           terminate.
  82.  
  83.      MMMMLLLLTTTT  Multiple of CPUs allowed by the submitter for scheduling
  84.           flexibility, if total cpus requested not available.  See
  85.           _m_i_s_e_r__s_u_b_m_i_t(_4).
  86.  
  87.      PPPPRRRRIIII  The priority is a field provided for use by scheduling policies (to
  88.           be implemented).
  89.  
  90.      OOOOPPPPTTTT  The option field indicates STATIC (S) for STATIC submission, and/or
  91.           kill (K) as exception handler flag.  Kill is the only exception
  92.           handling provided today.
  93.  
  94. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  95.      ----qqqq _q_n_a_m_e
  96.           Specifies the queue against which to schedule the application.  The
  97.           user must have execute permissions on the queue definition file to
  98.           schedule an application against the resources of a particular queue.
  99.           The queue name must be a valid queue name.
  100.  
  101.      ----oooo _c=CCCCPPPPUUUUssss,_m=mmmmeeeemmmm,_t=ttttiiiimmmmeeee[,_s_t_a_t_i_c]
  102.           Specifies a block of resources from the command line.
  103.  
  104.           The CPUs must be some integer up to the maximum number of CPUs
  105.           available to the queue being scheduled against.
  106.  
  107.           The memory, total job memory for all requested CPUs, consists of an
  108.           integer followed by a unit of _k for kilobyte, _m for megabyte or _g
  109.           for gigabyte.  The memory requested cannot exceed the total memory
  110.           available to the queue.  If no unit is specified, the default is
  111.           bytes.
  112.  
  113.           The time, total wall clock time requested for the job (time = wall
  114.           clock time per CPU * number of CPUs), can be specified either by an
  115.           integer followed by a unit specifier of _h for hours, _m for minutes
  116.           or _s for seconds, or by a string of the form _h_h:_m_m._s_s. An integer
  117.           with no units is assumed to be seconds.
  118.  
  119.           _s_t_a_t_i_c is an optional argument.  A job with this option enabled will
  120.           not run opportunistically. On a queue with a default scheduling
  121.           policy, it will not run earlier, even if idle resources become
  122.           available, after the job has been scheduled.  On a queue with a
  123.           repack policy the entire job schedule is reevaluated and updated
  124.           each time any job ends and the job may run earlier than originally
  125.           scheduled.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))                                                mmmmiiiisssseeeerrrr____ssssuuuubbbbmmmmiiiitttt((((1111))))
  137.  
  138.  
  139.  
  140.      ----ffff _f_i_l_e
  141.           This file specifies a list of resource segments.  Using the file
  142.           allows greater control over the scheduling parameters of a
  143.           particular job.
  144.  
  145.      ----hhhh   Prints the command's usage message.
  146.  
  147. RRRREEEESSSSTTTTRRRRIIIICCCCTTTTIIIIOOOONNNNSSSS
  148.      An application scheduled by _m_i_s_e_r(_1) cannot change its process group or
  149.      session ID.  If it tries to, an error is returned.
  150.  
  151.      An application that is scheduled by _m_i_s_e_r(_1) cannot change its priority,
  152.      or bind itself to a particular CPU.
  153.  
  154. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  155.      miser(1), miser(4), miser(5), miser_jinfo(1), miser_kill(1),
  156.      miser_move(1), miser_qinfo(1), miser_reset(1), miser_submit(4).
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.